package org.dromara.system.controller.system;

import cn.dev33.satoken.annotation.SaCheckPermission;
import cn.hutool.core.util.ObjectUtil;
import jakarta.servlet.http.HttpServletResponse;
import lombok.RequiredArgsConstructor;
import org.dromara.common.core.domain.R;
import org.dromara.common.excel.utils.ExcelUtil;
import org.dromara.common.log.annotation.Log;
import org.dromara.common.log.enums.BusinessType;
import org.dromara.common.mybatis.core.page.PageQuery;
import org.dromara.common.mybatis.core.page.TableDataInfo;
import org.dromara.common.web.core.BaseController;
import org.dromara.system.domain.bo.SysDictDataBo;
import org.dromara.system.domain.vo.SysDictDataVo;
import org.dromara.system.service.ISysDictDataService;
import org.dromara.system.service.ISysDictTypeService;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;

import java.util.ArrayList;
import java.util.List;


/**
 * @Author 刘武贵
 * @Date 2024/8/15 22:00
 * @Description 功能描述：数据字典信息
 */
@Validated
@RequiredArgsConstructor
@RestController
@RequestMapping("/system/dict/data")
public class SysDictDataController extends BaseController {

    /**
     * 字典 业务层（数据）
     */
    private final ISysDictDataService dictDataService;

    /**
     * 字典 业务层（类型）
     */
    private final ISysDictTypeService dictTypeService;

    /**
     * 查询字典数据列表
     *
     * @param dictData 字典数据查询条件封装类
     * @param pageQuery 分页查询条件封装类
     * @return 返回分页的字典数据信息
     */
    @SaCheckPermission("system:dict:list")
    @GetMapping("/list")
    public TableDataInfo<SysDictDataVo> list(SysDictDataBo dictData, PageQuery pageQuery) {
        return dictDataService.selectPageDictDataList(dictData, pageQuery);
    }

    /**
     * 导出字典数据列表
     *
     * @param dictData 字典数据查询条件对象，用于筛选需要导出的字典数据
     * @param response 用于向客户端返回导出的Excel文件
     */
    @Log(title = "字典数据", businessType = BusinessType.EXPORT)
    @SaCheckPermission("system:dict:export")
    @PostMapping("/export")
    public void export(SysDictDataBo dictData, HttpServletResponse response) {
        // 根据传入的查询条件，查询需要导出的字典数据列表
        List<SysDictDataVo> list = dictDataService.selectDictDataList(dictData);
        // 使用ExcelUtil工具类将查询到的字典数据列表导出为Excel文件，并发送给客户端
        ExcelUtil.exportExcel(list, "字典数据", SysDictDataVo.class, response);
    }

    /**
     * 查询字典数据详细
     * 该方法用于通过字典编码查询对应的字典数据详情，它调用字典数据服务中的方法
     * 根据提供的字典编码查询字典数据，并将结果封装在一个响应结果对象中返回
     *
     * @param dictCode 字典code
     * @return 返回封装了字典数据信息的响应结果对象
     */
    @SaCheckPermission("system:dict:query")
    @GetMapping(value = "/{dictCode}")
    public R<SysDictDataVo> getInfo(@PathVariable Long dictCode) {
        return R.ok(dictDataService.selectDictDataById(dictCode));
    }

    /**
     * 根据字典类型查询字典数据信息
     * 本方法通过调用字典类型服务，根据给定的字典类型获取相应的字典数据列表如果查询结果为空，则返回一个空列表
     *
     * @param dictType 字典类型
     * @return 返回字典数据列表，如果找不到对应类型的数据，则返回空列表
     */
    @GetMapping(value = "/type/{dictType}")
    public R<List<SysDictDataVo>> dictType(@PathVariable String dictType) {
        // 调用服务方法，根据字典类型查询字典数据
        List<SysDictDataVo> data = dictTypeService.selectDictDataByType(dictType);
        // 检查查询结果是否为空，如果为空则初始化为空列表
        if (ObjectUtil.isNull(data)) {
            data = new ArrayList<>();
        }
        return R.ok(data);
    }

    /**
     * 新增字典类型
     * 该方法用于向系统字典中添加新的字典数据项 首先，它会检查尝试添加的字典数据是否唯一，即系统中不存在具有相同键值的字典数据如果检查通过，
     * 则会将新的字典数据插入到系统字典中 否则，将返回失败消息，提示用户字典键值已存在
     *
     * @param dict 待添加的字典数据，通过@Validated注解进行参数有效性校验
     * @return R<Void> 返回一个结果对象，其中不包含数据实体，用于表示操作是否成功
     */
    @SaCheckPermission("system:dict:add")
    @Log(title = "字典数据", businessType = BusinessType.INSERT)
    @PostMapping
    public R<Void> add(@Validated @RequestBody SysDictDataBo dict) {
        if (!dictDataService.checkDictDataUnique(dict)) {
            return R.fail("新增字典数据'" + dict.getDictValue() + "'失败，字典键值已存在");
        }
        dictDataService.insertDictData(dict);
        return R.ok();
    }

    /**
     * 修改保存字典类型
     * 在修改字典数据之前，会校验字典键值的唯一性
     * 如果唯一性校验失败，则返回失败结果，否则更新字典数据并返回成功结果
     *
     * @param dict 待修改的字典数据，经过校验器验证
     * @return 如果修改成功，返回成功结果；否则返回失败结果
     */
    @SaCheckPermission("system:dict:edit")
    @Log(title = "字典数据", businessType = BusinessType.UPDATE)
    @PutMapping
    public R<Void> edit(@Validated @RequestBody SysDictDataBo dict) {
        // 检查字典数据的唯一性，如果唯一性校验失败，则返回修改失败的提示信息
        if (!dictDataService.checkDictDataUnique(dict)) {
            return R.fail("修改字典数据'" + dict.getDictValue() + "'失败，字典键值已存在");
        }
        dictDataService.updateDictData(dict);
        return R.ok();
    }

    /**
     * 删除字典类型
     *
     * @param dictCodes 字典code串
     * @return 返回一个响应对象，包含空的数据类型，表示操作成功
     */
    @SaCheckPermission("system:dict:remove")
    @Log(title = "字典类型", businessType = BusinessType.DELETE)
    @DeleteMapping("/{dictCodes}")
    public R<Void> remove(@PathVariable Long[] dictCodes) {
        dictDataService.deleteDictDataByIds(dictCodes);
        return R.ok();
    }
}
